<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>MongoId 类</title>

 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="mongo.types.html">Types</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="mongoid.construct.html">MongoId::__construct</a></div>
 <div class="up"><a href="mongo.types.html">Types</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="class.mongoid" class="reference">

 <h1 class="title">MongoId 类</h1>
 

 <div class="partintro"><p class="verinfo">(PECL mongo &gt;=0.8.0)</p>


  <div class="section" id="mongoid.intro">
   <h2 class="title">简介</h2>
   <p class="para">
    为数据库对象创建的唯一标识符。
    如果插入数据库的对象不具有 _id 字段，将会为 _id 
    字段添加一个 <strong class="classname">MongoId</strong> 实例作为值。
    如果数据具有自然的唯一字段（比如说，用户名或 timestamp），用来作为 _id 字段也不错，它不会被
    一个 <strong class="classname">MongoId</strong> 替换。
   </p>
   <p class="para">
    <strong class="classname">MongoId</strong> 类实例满足了关系数据库中自增列的角色：
    如果数据不具有天然的唯一键，则提供一个。
    自增列在分布式数据库中不会工作得很好，因为它无法快速找到下一个数字。
    这个类能够满足在分布式下快速产生唯一值的条件。
   </p>
   <p class="para">
    每个 MongoId 具有 12 个字节（使它的字符串形式是 24 个十六进制字符）。
    前四个字节是一个时间戳（timestamp），后三个是客户端主机名的 hash 摘要，然后两个是运行脚本的进程 ID，
    最后三位是一个自增值。
   </p>
   <p class="para">
    <strong class="classname">MongoId</strong> 是可以序列化/反序列化的。
    它们序列化后的格式和它们的字符串格式比较像：
    <div class="example-contents screen">
<div class="cdata"><pre>
C:7:&quot;MongoId&quot;:24:{4af9f23d8ead0e1d32000000}
</pre></div>
    </div>
   </p>
  </div>


  <div class="section" id="mongoid.synopsis">
   <h2 class="title">类摘要</h2>


   <div class="classsynopsis">
    <div class="ooclass"></div>


    <div class="classsynopsisinfo">
     <span class="ooclass">
      <strong class="classname">MongoId</strong>
     </span>
     {</div>


    <div class="fieldsynopsis">
     <span class="modifier">public</span>
     <span class="type">string</span>
      <var class="varname"><a href="class.mongoid.html#mongoid.props.id">$<var class="varname">id</var></a></var>
     <span class="initializer"> = <strong><code>NULL</code></strong></span>
    ;</div>

    
    <div class="classsynopsisinfo classsynopsisinfo_comment">/* 方法 */</div>
    <div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="methodname"><a href="mongoid.construct.html" class="methodname">__construct</a></span>
    ([ <span class="methodparam"><span class="type">string</span> <code class="parameter">$id</code><span class="initializer"> = <strong><code>NULL</code></strong></span></span>
  ] )</div>
<div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="modifier">static</span> <span class="type">string</span><span class="methodname"><a href="mongoid.gethostname.html" class="methodname">getHostname</a></span>
    ( <span class="methodparam">void</span>
   )</div>
<div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="type">int</span><span class="methodname"><a href="mongoid.getinc.html" class="methodname">getInc</a></span>
    ( <span class="methodparam">void</span>
   )</div>
<div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="type">int</span><span class="methodname"><a href="mongoid.getpid.html" class="methodname">getPID</a></span>
    ( <span class="methodparam">void</span>
   )</div>
<div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="type">int</span><span class="methodname"><a href="mongoid.gettimestamp.html" class="methodname">getTimestamp</a></span>
    ( <span class="methodparam">void</span>
   )</div>
<div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="modifier">static</span> <span class="type">MongoId</span><span class="methodname"><a href="mongoid.set-state.html" class="methodname">__set_state</a></span>
    ( <span class="methodparam"><span class="type">array</span> <code class="parameter">$props</code></span>
   )</div>
<div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="type">string</span><span class="methodname"><a href="mongoid.tostring.html" class="methodname">__toString</a></span>
    ( <span class="methodparam">void</span>
   )</div>

   }</div>


  </div>

  <div class="section">
   <h2 class="title">Fields</h2>
   <dl>

    
     <dt id="mongoid.props.id"><var class="varname"><var class="varname">id</var></var></dt>

     <dd>

      <span class="simpara">
       这个字段包含了该对象的字符串表达形式。
      </span>
     </dd>

    
   </dl>

  </div>

  <div class="section">
   <h2 class="title">参见</h2>
   <p class="para">
    关于 <a href="http://docs.mongodb.org/manual/reference/object-id/" class="link external">&raquo;&nbsp;ids</a> 的 MongoDB 核心文档。
   </p>
  </div>
 </div>

 
































































<h2>Table of Contents</h2><ul class="chunklist chunklist_reference"><li><a href="mongoid.construct.html">MongoId::__construct</a> — 创建一个新的id</li><li><a href="mongoid.gethostname.html">MongoId::getHostname</a> — 获取这台机器上 id 所使用的 hostname</li><li><a href="mongoid.getinc.html">MongoId::getInc</a> — 返回用于创建 id 所增加的值</li><li><a href="mongoid.getpid.html">MongoId::getPID</a> — 获取进程 ID</li><li><a href="mongoid.gettimestamp.html">MongoId::getTimestamp</a> — 获取新纪元时间到 id 创建时的秒数。</li><li><a href="mongoid.set-state.html">MongoId::__set_state</a> — 创建一个假的 MongoId</li><li><a href="mongoid.tostring.html">MongoId::__toString</a> — 返回该 id 十六进制的表示形式</li></ul>
</div>
<hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="mongo.types.html">Types</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="mongoid.construct.html">MongoId::__construct</a></div>
 <div class="up"><a href="mongo.types.html">Types</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
